6

Kodning af indhold

Med XML kan du kode ­ afmærke ­ indholdet i dokumenter. Når du koder, kan du afmærke forskellige dele af dokumenter. Du kan herefter anvende det kodede indhold på forskellige måder, herunder på World Wide Web.

Avenue.quark giver dig en unik metode til kodning af tekst og billeder i QuarkXPress Passport-dokumenter. Du kan kode elementer manuelt eller anvende kodningsregelsæt til at automatisere en del af kodningsprocessen.


Oprette, åbne og gemme XML-dokumenter

Med avenue.quark kan du oprette og åbne XML-dokumenter fra menuen Arkiv (Mac OS) eller Fil (Windows). Du kan gemme XML-dokumenter vha. knapper på paletten XML-arbejdsområde.


Oprettelse af et XML-dokument

Sådan opretter du et nyt XML-dokument:

1. Vælg Arkiv (Mac OS) eller Fil (Windows) > Ny > XML, eller tryk på Command+Shift+X(Mac OS) eller Ctrl+Shift+X (Windows). Dialogen Ny XML vises.


Med dialogen Ny XML kan du oprette et nyt XML-dokument.

2. Hvis du vil basere det nye XML-dokument på en XML-skabelon, skal du vælge et objekt på listen Skabelon. Hvis du vil oprette et nyt XML-dokument, der ikke er baseret på en skabelon, skal du klikke på Importér i området DOCTYPE, vælge en DTD og herefter vælge et rodelement i lokalmenuen Rodelement.


Se "Arbejde med XML-skabeloner" i dette kapitel for flere oplysninger om XML-skabeloner.


3. Baserer du det nye XML-dokument på en skabelon, og planlægger du at anvende regelbaseret kodning, skal du vælge et standardsæt med kodningsregler i lokalmenuen Standardsæt.


4. Klik på OK. Det nye XML-dokument vises i en ny XML-arbejdsområde-palet.


Når du er færdig med dette trin, kan XML-dokumentets DTD og rodelement ikke ændres.


Som standard indeholder et nyt XML-dokument kun de elementer der ifølge DTD'en er obligatoriske på rodniveauet, samt alle nødvendige produkter af disse elementer. Hvis DTD'en kræver en værdi fra en liste med ikke-valgfrie elementer (f.eks. (a | b | c)), anvender avenue.quark det første element på listen (i dette tilfælde a). Hvis DTD'en kræver en værdi fra en liste med elementer, og et eller flere af disse elementer er valgfrie (f.eks. (a | b | c?)), efterlader avenue.quark det overordnede element tomt.

Avenue.quark opretter kun gyldige XML-dokumenter (det vil sige dokumenter, der overholder deres DOCTYPE).


Ønsker du at oprette et nyt dokument, baseret på en XML-skabelonfil der ikke findes i mappen "Skabeloner" i QuarkXPress Passport-mappen, skal du blot vælge Arkiv (Mac OS) eller Fil (Windows) > Åbn og åbne XML-skabelonfilen på denne måde.



Åbning af et XML-dokument

Med avenue.quark kan du åbne XML-dokumenter, der er oprettet med avenue.quark, eller et andet gyldigt XML-dokument der indeholder dets DTD eller henvisninger til en tilgængelig DTD. Sådan åbner du et XML-dokument i avenue.quark:

1. Vælg Arkiv (Mac OS) eller Fil (Windows) > Åbn (Command+O på Mac OS, Ctrl+O på Windows).


2. Kun Windows: Vælg XML (*.xml) i lokalmenuen Filtype.


3. Anvend kontrollerne i dialogen til at finde det dokument, du vil åbne, og fremhæv herefter dokumentet på listen.


Avenue.quark kan kun åbne XML-dokumenter med suffikset ".xml".


4. Klik på Åbn.


5. Hvis XML-filen er oprettet med avenue.quark, forsøger avenue.quark at åbne det QuarkXPress Passport-dokument, der senest har leveret indhold til det. Kan avenue.quark ikke finde QuarkXPress Passport-dokumentet, vises en dialog, der beder dig om at finde det. Du kan vælge QuarkXPress Passport-filen og klikke på Åbn eller klikke på Annullér. (XML-filen forbliver åbent, selvom du klikker på Annullér).


Hvis der vises en "XML-dokumentfejl" meddelelse betyder dette at det dokument, du åbner, indeholder en fejl. "XML-dokumentfejl" efterfølges af en fejltype og et linie- og spaltenummer (i nævnte orden) på det tegn, der udløste fejlen.


6. Hvis QuarkXPress Passport-dokumentet er tilgængeligt, sammenligner avenue.quark indholdet i dokumentet med det tilhørende indhold i XML-dokumentet og fortæller dig, hvis der er forskel.


Avenue.quark understøtter tegnkodningerne UTF-8, UTF-16 (Unicode) og Shift-JIS, og tilføjer automatisk en tegnkodningspecifikation, når du gemmer en XML-fil. Hvis en XML-fil ikke indeholder en tegnkodningspecifikation, anvender avenue.quark tegnkodningen UTF-8. Se appendiks C "Sådan fungerer tegnkodning" i kapitel 7 "Appendiks" for flere oplysninger om tegnkodning.



Arkivering af et XML-dokument

Med knapper på paletten XML-arbejdsområde kan du gemme XML-dokumenter under deres aktuelle navne eller under et nyt navn.

Fra venstre til højre: Knapperne Arkivér (Mac OS) eller Gem (Windows), Arkivér som (Mac OS) eller Gem som (Windows) og Hent seneste.

I dialogen Arkivér som (Mac OS) eller Gem som (Windows) kan du give XML-filen et navn. Bestem, om filen skal gemmes som et XML-dokument eller som en avenue.quark-skabelon, og vælg en tegnkodningsmetode.

Når du gemmer et XML-dokument i avenue.quark sker der forskellige ting:


Arbejde med XML-skabeloner

En XML-skabelon er et avenue.quark-XML-dokument der indeholder en DTD, en rodelementspecifikation og et (valgfrit) standardkodningsregelsæt. En XML-skabelon kan også indeholde et "startsæt" med elementer, attributter, kommentarer, behandlingsinstruktioner, PCDATA-blokke samt indhold. Formålet med XML-skabeloner er at spare brugerne for at gentage de samme forberedelser igen og igen, når der oprettes et antal XML-dokumenter der alle er baseret på den samme DTD, det samme rodelement og det samme kodningsregelsæt.

For at være tilgængelige i avenue.quark skal XML-skabeloner være arkiveret i mappen "Templates", som er placeret i den samme mappe som QuarkXPress Passport. XML-skabeloners filnavn skal have suffikset ".xmt" ­ også under Mac OS.



Oprettelse af en XML-skabelon

Sådan opretter du en ny XML-skabelon:

1. Vælg Arkivér (Mac OS) eller Gem (Windows) > Ny > XML, eller tryk på Command+Shift+X (Mac OS) eller Ctrl+Shift+X (Windows). Dialogen Ny XML vises.


2. Hvis du vil basere skabelonen på en anden skabelon, skal du vælge navnet på denne skabelon på listen Skabelon og gå til trin 4.


I dialogen Ny XML kan du oprette nye XML-skabeloner.

3. Hvis du vil oprette skabelonen fra grunden, skal du vælge Custom.xmt på listen Skabelon, klikke på Importér i området DOCTYPE og vælge en DTD-fil. Vælg herefter et rodelement i lokalmenuen Rodelement.


4. Hvis du baserer den nye skabelon på en eksisterende skabelon, og du planlægger at anvende regelbaseret kodning, skal du vælge et standardsæt med kodningsregler i lokalmenuen Standardsæt.


5. Klik på OK. Det nye XML-dokument vises på en ny XML-arbejdsområde-palet.


6. Tilføj de elementer, attributter, kommentarer behandlingsinstruktioner, PCDATA-blokke eller indhold som skabelonen skal indeholde.


7. Klik på knappen Arkivér som (Mac OS) eller Gem som (Windows). Dialogen Arkivér som (Mac OS) eller Gem som (Windows) vises.


I dialogen Arkivér som (Mac OS) eller Gem som (Windows) kan du give en XML-fil et navn og angive, om du vil gemme filen som et XML-dokument eller en avenue.quark-skabelon samt angive en tegnkodningsmetode til filen.

8. Giv filen et navn i feltet Arkivér aktuel XML som (Mac OS) eller Gem aktuel XML som (Windows). Vær opmærksom på, at XML-skabeloner skal have et filnavn, der slutter med ".xmt" ­ også under Mac OS.


9. Vælg avenue.quark-skabelon i lokalmenuen Type.


10. Vælg en tegnkodningsmetode i lokalmenuen Tegnkodning.


11. Hvis skabelonen skal vises i dialogen Ny XML skal du navigere til mappen "Templates" i QuarkXPress Passport-mappen. (Skabeloner der ikke er gemt i mappen "Templates" kan åbnes med Arkiv (Mac OS) eller Fil (Windows) > Åbn).


12. Klik på Arkivér (Mac OS) eller Gem (Windows).


Skabeloner gemmes altid som standalone-dokumenter, fordi de skal indeholde en DTD.



Arbejde med XML-dokumentindhold

Med det hierarkiske XML-træ på paletten XML-arbejdsområde er det let at se på og arbejde med indholdet i XML-dokumenter. En praktisk lokalmenu gør det nemt at indsætte, slette og erstatte elementer, kommentarer, PCDATA-blokke og behandlingsinstruktioner.


Indsættelse eller erstatning af et element, en kommentar, en PCDATA-blok eller en behandlingsinstruktion

Du kan indsætte et nyt element, en ny kommentar, en ny PCDATA-blok eller en ny behandlingsinstruktion over, under eller som et produkt af det objekt der er valgt på listen XML-træ (paletten XML-arbejdsområde). Du kan også erstatte det valgte objekt med et andet objekt, hvis DTD'en tillader det. Sådan indsætter eller erstatter du et objekt i det aktive XML-dokument:

1. Vælg et objekt på listen XML-træ på paletten XML-arbejdsområde.


2. Hold Ctrl-tasten nede og klik (Mac OS) eller højreklik (Windows) på objektet for at vise lokalmenuen XML-træ, og vælg herefter Indsæt produkt, Indsæt sideprodukt før, Indsæt sideprodukt efter eller Erstat. Der vises en undermenu.


I undermenuen for kommandoerne Indsæt produkt, Indsæt sideprodukt før, Indsæt sideprodukt efter og Erstat kan du vælge hvilken elementtype, du vil indsætte eller erstatte.

3. Hvis du vil indsætte eller erstatte et element, en kommentar, en behandlingsinstruktion eller en PCDATA-blok uden at se et eksempel, skal du blot vælge det i undermenuen.


4. Hvis du ønsker at se et eksempel, inden du indsætter eller erstatter, vælg Indsæt produkt, Indsæt sideprodukt før eller Indsæt sideprodukt efter.


Dialogen Indsæt med eksempel.

Listen Objekter er en liste med objekter der kan indsættes eller erstattes. Listen Eksempel på XML-træ viser det valgte objekt og alle dets obligatoriske produkter (med sort skrift) i XML-træets indhold (med grå skrift). Du kan forestille dig det som et eksempel på, hvordan dokumentet vil se ud efter ændringen. Hvis det er nødvendigt at slette nogle elementer i processen, vises disse med rød, overstreget skrift. Klik på OK for at indsætte eller udskifte, eller klik på Annullér for at afbryde.

Nogle elementer indeholder obligatoriske produkter. Hvis du indsætter et sådant element, skal dets krævede produkter også indsættes. Når du klikker på et elements -symbol (Mac OS) eller (Windows), vises de produktelementer der også skal indsættes sammen med det pågældende element. Når du klikker på dette symbol, vises de eventuelle ekstra produkter som et element kan have ikke.


Hvis et indsat element kræver en værdi fra en liste med ikke-valgfrie elementer (f.eks. (a | b | c)), anvender avenue.quark det første element på listen (i dette tilfælde a). Hvis elementet kræver en værdi fra en liste med elementer, og et eller flere af disse elementer er valgfrie (f.eks. (a | b | c?)), efterlader avenue.quark elementet tomt.


Hvis det ønskede element ikke er tilgængeligt, betyder det at DTD'en ikke tillader at nye elementer af denne type indsættes på dette sted.


Hvad er en PCDATA-blok? En PCDATA-blok er en avenue.quark-mekanisme, du kan anvende til opdeling af teksten i et element i separate dele. PCDATA-blokke kan kun ses i avenue.quark. I den eksporterede XML flettes sammenhørende PCDATA-blokke.



Sletning af et element, en kommentar, en PCDATA-blok eller en behandlingsinstruktion

Sådan sletter du et element, en kommentar, en PCDATA-blok eller en behandlingsinstruktion:

1. Vælg det objekt du vil slette på listen XML-træ på paletten XML-arbejdsområde.


2. Hold Ctrl-tasten nede og klik (Mac OS) eller højreklik (Windows) for at vise lokalmenuen XML-træ, og vælg herefter Slet. Dialogen Slet vises.


Dialogen Slet.

Hvis menuobjektet Slet ikke er tilgængeligt betyder det, at DTD'en ikke tillader at du sletter det valgte element.


Listen Objekter viser det objekt der skal slettes. Listen Eksempel på XML-træ viser,hvordan XML-træet vil se ud, når du har slettet. Objekter der vil blive slettet, vises med rød, overstreget skrift.

3. Klik på OK for at afslutte sletningen eller klik på Annullér for at afbryde den.



Kodning af tekst

Når du bruger avenue.quark til kodning af indhold, skal du anvende en DTD ­ se "Arbejde med DTD'er" i kapitel 1 "Start på avenue.quark". Når du koder tekst, knytter du den pågældende tekst til elementtyper i den relevante DTD.

Du kan kode tekst i avenue.quark på flere måder. Du kan kode teksten manuelt, automatisere kodningen med et kodningsregelsæt eller skrive indhold manuelt


Manuel kodning af tekst

Anvend manuel tekstkodning når du ønsker præcis kontrol med hvilken tekst der knyttes til hvilke elementer. Sådan koder du tekst manuelt fra det aktive QuarkXPress Passport-dokument og kopierer den til det aktive XML-dokument:

1. Flyt frem til den side i QuarkXPress Passport-dokumentet der indeholder den tekst, du vil kode, og vælg herefter den pågældende tekst med værktøjet Indhold E.


2. Rul på listen XML-træ på paletten XML-arbejdsområde, til du kan se det element eller den attribut, du vil kode den valgte tekst med. (Se "Arbejde med XML-dokumentindhold" i dette kapitel, hvis du har brug for at oprette elementer eller attributter).


Kun attributter der er specificeret som CDATA-attributter kan anvendes til kodning af tekst. Faste og tomme attributter kan ikke anvendes til kodning af tekst.


3. Klik på og træk den valgte tekst til element- eller attributnavnet på listen XML-træ. Teksten kopieres til elementet eller attributten.


Hvis elementet eller attributten allerede indeholder tekst erstattes denne.


4. Du kan sikre dig at indholdet er kodet korrekt ved at vælge elementet på listen XML-træ. Den tekst som elementet eller attributten indeholder bliver vist i feltet Indhold.


Hvis du trækker tekst til en NMTOKENS- eller IDREFS-attribut, opfattes mellemrum i teksten som separatorer mellem objekter i en liste med NMTOKEN'er eller IDREF'er.



Kodning af tekst med regelbaseret kodning

Med regelbaseret kodning kan du automatisere dele af processen med kodning af tekst og billeder. For at kunne anvende regelbaseret kodning skal du oprette et kodningsregelsæt (se kapitel 5 "Kodningsregelsæt"). Herefter kan du bruge dette kodningsregelsæt til automatisering af dele af kodningsprocessen.

Sådan anvender du regelbaseret kodning til kodning af tekst fra det aktive QuarkXPress Passport-dokument til det aktive XML-dokument:

1. Vælg et kodningsregelsæt i lokalmenuen Kodningsregelsæt på paletten XML-arbejdsområde.


2. Rul på listen XML-træ indtil du kan se det element, hvorfra du vil starte den regelbaserede kodning. For at den regelbaserede kodning skal kunne fungere skal der være oprettet mindst én regel for dette element eller dets produkter i det valgte kodningsregelsæt.


3. Vælg et tekstområde med værktøjet Indhold E eller et tekstfelt med værktøjet Objekt e.


4. Tryk på Command-tasten (Mac OS) eller Ctrl-tasten (Windows), klik herefter på og træk den valgte tekst eller det valgte tekstfelt til elementnavnet på listen XML-træ. Teksten kopieres til XML-dokumentet i overensstemmelse med reglerne i det valgte kodningsregelsæt. Avenue.quark føjer nye elementer til XML-dokumentet efter behov, så der er plads til det kodede indhold. Opstår der en ikke-entydig kodningssituation viser avenue.quark en dialog, hvori du bliver spurgt hvad du vil foretage.


5. Du kan sikre dig at indholdet er kodet korrekt ved at vælge hvert element på listen XML-træ. Den tekst som elementet indeholder vises i feltet Indhold.


6. Du kan sikre dig at avenue.quark har kodet al den tekst, du ønsker at kode, ved at vælge Vis kodet indhold i menuen Ekstra. Kodet og ikke-kodet tekst og billeder vises med de farver, der er valgt i dialogen avenue.quark-valg (Redigér > Valg > avenue.quark).


Kommandoen Vis kodet indhold fungerer kun i QuarkXPress Passport 4.1 eller nyere.



Redigering af kodet tekst

Når du har kodet tekst i et QuarkXPress Passport-dokument kan du redigere teksten i QuarkXPress Passport-dokumentet. Herefter opdateres teksten automatisk på paletten XML-arbejdsområde. Hvis XML-dokumentet ikke er åbent når du redigerer, opdateres teksten næste gang begge dokumenter er åbne.

Automatisk opdatering af indhold fungerer kun med elementer. Attributter opdateres ikke automatisk.


Hvis du vil afbryde kæden mellem et QuarkXPress Passport-dokument og et element i det aktive QuarkXPress Passport-dokument, skal du vælge elementet eller attributten på listen XML-træ og herefter klikke på knappen Afbryd dynamisk kæde.

Med knappen Afbryd dynamisk kæde kan du afbryde kæden mellem det element, der er valgt på listen XML-træ, og det QuarkXPress Passport-dokument det stammer fra.


Kodning af billeder

Sådan koder du billeder fra det aktive QuarkXPress Passport-dokument og kopierer deres filnavne til det aktive XML-dokument:

1. Flyt til den side i QuarkXPress Passport-dokumentet der indeholder det billede, du vil kode, og vælg herefter dets billedfelt.


2. Rul på listen XML-træ på paletten XML-arbejdsområde til du kan se det element eller den attribut, du vil kode det valgte billede med. (Se "Arbejde med XML-dokumentindhold" i dette kapitel, hvis du har brug for at oprette elementer eller attributter).


Kun attributter der er specificeret som CDATA-attributter kan anvendes til kodning af billeder. Faste og tomme attributter kan ikke anvendes til kodning af billeder.


3. Tryk på Command-tasten (Mac OS) eller på Ctrl-tasten (Windows), og klik herefter på og træk det valgte billede til element- eller attributnavnet på listen XML-træ. Billedets navn kopieres til det valgte element eller den valgte attribut.


Hvis målelementet eller -attributten allerede indeholder et navn erstatter det nye navn altid det eksisterende.



Manuel indtastning af indhold

Ud over at kopiere indhold fra et QuarkXPress Passport-dokument kan du med avenue.quark tilføje yderligere indhold ved at skrive det direkte i XML-dokumentet. Sådan føjer du nyt indhold til et tomt element, en tom attribut eller en tom kommentar i det aktive XML-dokument:

1. Vælg på listen XML-træ det element, den attribut eller den kommentar, du vil føje indhold til. (Se "Arbejd med XML-dokumentindhold" i dette kapitel, hvis du har brug for at oprette det).


Attributter kan kun indeholde manuelt indtastet indhold, hvis de er specificeret som CDATA-attributter. Faste og tomme attributter kan ikke indeholde manuelt indtastet indhold.


2. Skriv indholdet i feltet Indhold.


Du kan også indsætte indhold fra Udklipsholderen i feltet Indhold. Bemærk, at sådan tekst mister al den formatering den måtte være forsynet med, og indsættes som almindelig ASCII-tekst.


3. Når du er færdig med at redigere det valgte element, skal du trykke på Tab-tasten.


Du kan kun tilføje indhold manuelt til elementer, der ikke består af indhold fra et QuarkXPress Passport-dokument. Består et element af indhold fra et QuarkXPress Passport-dokument, skal du redigere indholdet i QuarkXPress Passport-dokumentet. Herefter opdateres kopien af teksten i XML-dokumentet automatisk.



Visning af kodet tekst

Når indholdet er kodet kan du se hvordan det vil se ud når det gemmes som XML. Hvis du vil se det XML-dokument der vises i den aktive XML-arbejdsområde-palet, skal du klikke på knappen Vis XML. Dialogen Vis XML vises.

Knappen Vis XML

Med dialogen Vis XML kan du se den XML der bliver oprettet, når du gemmer det aktive XML-dokument.

Du kan kopiere tekst fra dialogen Vis XML, men du kan ikke redigere eller slette teksten.


Selvom de høje ASCII-tegn (tegn, hvis værdi er højere end ASCII 127) vises uændret i dialogen Vis XML, konverteres sådanne tegn til de korrekte koder når de eksporteres. Det afhænger af den tegnkodning du vælger i dialogen Arkivér som (Mac OS) eller Gem som (Windows).